Skip to content

Preview4 release notes#3992

Merged
mdaigle merged 9 commits intomainfrom
dev/mdaigle/preview4-release-notes
Mar 5, 2026
Merged

Preview4 release notes#3992
mdaigle merged 9 commits intomainfrom
dev/mdaigle/preview4-release-notes

Conversation

@mdaigle
Copy link
Contributor

@mdaigle mdaigle commented Feb 27, 2026

In addition to adding new release notes, this pull request also introduces a new, robust workflow for generating release notes by adding a dedicated skill for fetching milestone PRs and significantly expanding the release notes prompt. The main focus is to support multi-package release notes generation, automate PR metadata collection, and provide clear, step-by-step instructions for maintainers.

Key changes include:

Release Notes Prompt Overhaul

  • Multi-package support and detailed instructions:
    The .github/prompts/release-notes.prompt.md file is rewritten to handle multiple packages in the repository, with a registry table specifying how to identify relevant PRs and where to place release notes for each package. It now includes explicit steps for fetching PRs, categorizing changes, enriching feature sections, verifying API names, and updating various documentation files.

  • Integration of new fetch-milestone-prs skill:
    The prompt now relies on a new skill to programmatically fetch all merged PRs for a given milestone, saving their metadata for use in release note generation. This ensures accuracy and repeatability in the release process.

New Skill: fetch-milestone-prs

  • Skill documentation:
    Added .github/skills/fetch-milestone-prs/SKILL.md, which documents when and how to use the skill, prerequisites, output formats, error handling, and integration points with other workflows.

  • Skill implementation:
    Introduced .github/skills/fetch-milestone-prs/fetch-milestone-prs.py, a Python script that uses the GitHub CLI to fetch all merged PRs for a specified milestone, saves each as a JSON file, and creates an index for downstream processing. The script handles error cases, computes helpful derived fields for categorization, and is designed for easy automation.

These changes lay the foundation for a more automated, accurate, and maintainable release process across all packages in the repository.


Most important changes:

Release Notes Process Improvements

  • Major rewrite of .github/prompts/release-notes.prompt.md to support multi-package release notes, provide explicit instructions, and integrate with the new PR-fetching skill.

Skill Addition: PR Metadata Fetching

  • Added .github/skills/fetch-milestone-prs/SKILL.md documenting a new skill for fetching all merged PRs for a milestone, including usage scenarios, prerequisites, and output structure.
  • Implemented .github/skills/fetch-milestone-prs/fetch-milestone-prs.py, a Python script that automates fetching, filtering, and saving PR metadata for a milestone using the GitHub CLI, with robust error handling and output for downstream workflows.

Copilot AI review requested due to automatic review settings February 27, 2026 21:19
@github-project-automation github-project-automation bot moved this to To triage in SqlClient Board Feb 27, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds Preview4 release-note content and introduces a milestone-driven workflow to automate PR metadata collection for multi-package release notes in this repo.

Changes:

  • Added Preview4 release notes for Microsoft.Data.SqlClient 7.0 and related packages (AKV provider 7.0, new Extensions packages 1.0).
  • Added a new fetch-milestone-prs skill + Python script to collect merged milestone PR metadata into a local directory for downstream processing.
  • Overhauled the release-notes prompt to support multi-package release note generation using the new skill.

Reviewed changes

Copilot reviewed 19 out of 20 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
release-notes/template/release-notes-template.md Generalized template guidance for multi-package releases.
release-notes/add-ons/AzureKeyVaultProvider/7.0/README.md Added AKV provider 7.0 release index.
release-notes/add-ons/AzureKeyVaultProvider/7.0/7.0.0-preview4.md Added AKV provider 7.0.0-preview4 release notes.
release-notes/add-ons/AzureKeyVaultProvider/7.0/7.0.0-preview{1,2,3}.md Added placeholder notes indicating no package was shipped for those milestones.
release-notes/README.md Added top-level links/sections for new packages and AKV 7.0.
release-notes/Extensions/Abstractions/1.0/* Added Extensions.Abstractions 1.0 release index + preview1 notes.
release-notes/Extensions/Azure/1.0/* Added Extensions.Azure 1.0 release index + preview1 notes.
release-notes/Extensions/Logging/1.0/* Added Extensions.Logging 1.0 release index + preview1 notes.
release-notes/7.0/README.md Added 7.0.0-preview4 entry.
release-notes/7.0/7.0.0-preview4.md Added core driver 7.0.0-preview4 release notes.
CHANGELOG.md Added 7.0.0-preview4 changelog entry plus pointers to per-package release notes.
.gitignore Ignored generated .milestone-prs/ output.
.github/skills/fetch-milestone-prs/fetch-milestone-prs.py New script to fetch milestone PR metadata using gh api.
.github/skills/fetch-milestone-prs/SKILL.md Documentation for the new milestone PR fetch skill.
.github/prompts/release-notes.prompt.md Rewrote release-notes prompt for multi-package workflow + skill integration.

@paulmedynski paulmedynski self-assigned this Feb 27, 2026
Copy link
Contributor

@paulmedynski paulmedynski left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These notes look amazing! We're releasing AKV 7.0.0 Preview 1, not Preview 4, so that's the only correction. We need to fill in the actual build numbers once they are known.

@github-project-automation github-project-automation bot moved this from To triage to In progress in SqlClient Board Feb 27, 2026
samsharma2700
samsharma2700 previously approved these changes Feb 27, 2026
Copy link
Contributor

@samsharma2700 samsharma2700 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Notes look good just need to address the comments.

Copilot AI review requested due to automatic review settings March 2, 2026 17:15
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 16 out of 17 changed files in this pull request and generated 4 comments.

paulmedynski
paulmedynski previously approved these changes Mar 2, 2026
@paulmedynski paulmedynski added this to the 7.0.0-preview4 milestone Mar 2, 2026
Copilot AI review requested due to automatic review settings March 5, 2026 20:02
@paulmedynski paulmedynski marked this pull request as ready for review March 5, 2026 20:04
@paulmedynski paulmedynski requested a review from a team as a code owner March 5, 2026 20:05
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 16 out of 17 changed files in this pull request and generated 3 comments.

@mdaigle mdaigle merged commit 569ada7 into main Mar 5, 2026
5 checks passed
@mdaigle mdaigle deleted the dev/mdaigle/preview4-release-notes branch March 5, 2026 22:17
@github-project-automation github-project-automation bot moved this from In progress to Done in SqlClient Board Mar 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

5 participants